home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 151-175 / scopedisk153 / iconize / iconize.docs < prev    next >
Text File  |  1995-03-19  |  8KB  |  145 lines
  1. ----------------------------------------------------------------------------------
  2. |                                                                                |
  3. |                               I C O N I Z E                                    |
  4. |                                  (v.90)                                        |
  5. |                 (c) 1990, Rick Tillery, all rights reserved                    |
  6. |                                                                                |
  7. |                                                                                |
  8. ----------------------------------------------------------------------------------
  9. | This program is release into the public domain as long as all files listed     |
  10. | below are included in each transfer.  The source code is not included, but if  |
  11. | you REALLY want to know how I did this, drop me a line and I'll send you a     |
  12. | copy.                                                                          |
  13. ----------------------------------------------------------------------------------
  14. OK, here's the deal:  I have lots of IFF pictures that I love to show off.  I
  15.                       usually use a graphical shell to show them because it's
  16.                       easier and the stupid icons that paint programs use are
  17.                       ugly.  Now 2.0 MAY be coming out soon and I am working with
  18.                       a developer in beta testing it and it came to me that the
  19.                       built in 16 color (or 8 color or even 2 color) WorkBench
  20.                       would be a perfect oportunity to create some better icons.
  21.                       
  22.  
  23. First I developed a palette from the basic 2.0 palette of a medium grey, black,
  24. white, and a pastel blue.  I extended it to 16 colors to 15 grey shades and the
  25. blue in a way which allows the 16 color icons to be viewed in the reduced color
  26. modes with some semblance of legibility.  With this palette I used several
  27. commercial products to shrink, convert to grey scale and remap my pictures into
  28. brushes with this palette.  Then I used the Icon Editor in 2.0 to make them into
  29. icons (YES! 2.0 allows you to load IFF brushes as icons).
  30.  
  31. This took quite a bit of work, but I was so pleased with the results that I
  32. couldn't resist trying my hand at a program which would automate this creation
  33. of icons from IFF pictures.
  34.  
  35. Iconize (v.90) is the result (so far).
  36.  
  37. ----------------------------------------------------------------------------------
  38.  
  39. Included here:             Iconize (v.90) - the program itself
  40.                            Iconize.docs - the docs you are reading
  41.                            IFF.library - a public domain IFF handling library
  42.                            Palette.Brush - a brush with the appropriate palette
  43.  
  44. What is required:          One Amiga computer (not included)
  45.                            At least one IFF file (not included)
  46.                            Iconize and support files (included)
  47.                            Some time (more for bigger pics less for smaller ones)
  48.  
  49. ----------------------------------------------------------------------------------
  50.  
  51. Destructions:
  52.  
  53.                Iconize is a simple program that will convert your IFF files
  54.             into small project icons of 16, 8, 4(ugh), or 2(yech!) colors from a
  55.             standard palette.  You may specify the number of bitplanes (number of
  56.             colors = 2 raised to the power of the number of bitplanes), the stack
  57.             size, the default tool, the width and the height of the icon.
  58.  
  59.                The palette is included in the Palette.Brush file so you can load
  60.             it into the palette command under 2.0.  However, you may use this same
  61.             palette under 1.3 normally or with a WorkBench hack for increasing 
  62.             (or decreasing) the number of bitplanes.  For those of you in the
  63.             latter case, your palette should consist of the first n values in the
  64.             following list (where n is the number of colors on your WorkBench
  65.             screen):
  66.                      (hex values)  AAA, 000, FFF, 679, (this one is not important
  67.                                                        and is up to you)
  68.                                    888, 333, DDD, 666,
  69.  
  70.                                    BBB, 222, EEE, 555,
  71.  
  72.                                    999, 444, CCC, 777
  73.  
  74.             Just load these values in as your palette in whatever way is specified
  75.             by the particular hack you are using.
  76.  
  77. Usage:         To use Iconize you must first install the iff.library in your libs:
  78.             device (this should not interfere with the 2.0 iffparse.library).
  79.             Next be sure that Iconize is in your path somewhere.  Now you are
  80.             ready to attack those IFF files.
  81.  
  82. Caution:       Iconize will accept any or no arguments.  As such it is very
  83.             important that you are certain of what you are telling it before
  84.             pressing that return key.
  85.  
  86.             
  87. Syntax:     Iconize [filename(s)] an optional list of filenames, if no filename
  88.                                   is specified, Iconize will attempt to process
  89.                                   the ENTIRE current directory.
  90.  
  91.                     [?] or [-h] presents the version number and a short command
  92.                                 summary
  93.  
  94.                     [-dDefaultToolType] allows specification of the default tool
  95.                                         for the project icon (i.e. -dc:superview
  96.                                         would make c:superview the default tool)
  97.  
  98.                     [-p#BitPlanes] allows specification of the number of bitplanes
  99.                                    in the icon (i.e. -p3 would specify an 8 color
  100.                                    icon) {default is 16 color icon}
  101.  
  102.                     [-sStackSize] allow specification of the stack size provided
  103.                                   to the default tool {default stack is 4000}
  104.  
  105.                     [-xIconWidth] allows specification of the width of the
  106.                                   resulting icon (i.e. -x128 would specify a width
  107.                                   of 128 for the icon) {default width is 64}
  108.  
  109.                     [-yIconHeight] allows specification of the height of the icon
  110.  
  111. ----------------------------------------------------------------------------------
  112.  
  113. Upgrades: v.90 - first release into gamma testing
  114.  
  115. Please report any bugs to me and try to supply a copy of the problem causing file
  116. if you can.
  117.  
  118. ----------------------------------------------------------------------------------
  119.  
  120. Future enhancements:  Not rely on iff.library which wastes memory.
  121.                       
  122.                       Handle SHAM, Dynamic HAM and Dynamic Hi-Res pictures.
  123.  
  124.                       Increase speed by convering pixel read and write routines
  125.                       to assembly or using internal versions (I don't have any
  126.                       RKM's yet).
  127.  
  128. ----------------------------------------------------------------------------------
  129.  
  130. Report any bugs and send any awe inspiring IFF files or donations to (not
  131. requested but any and all accepted):
  132.  
  133.                       Rick Tillery
  134.                       
  135.                      {until May 1991}
  136.                       (405) 364-2372 (collect not accepted :-)
  137.                       314 E. Boyd #7
  138.                       Norman, OK, 73069
  139.  
  140.                      {after May 1991}
  141.                       5000 Ryan Dr.
  142.                       OKC, OK 73135
  143.  
  144.                       Cserve: 71020,1554
  145.